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PLATFORM-INDFPFNDENT UNIVERSAL DATA ACCESS SYSTEM AND 
METHOD TN A CLIENT-SERVER ENVIRONMENT 



Background of the invention 

1. Field Qf tfas invention 

This invention relates generally to client-server software systems and 
particularly to data access in a client-server environment. 

2. Description of the Related Art 

In the 1960's and 1970's computing was performed primarily by large 
mainframe computers servicing multiple users. Most users accessed the 
mainframe computer using a "dumb" terminal that had very little memory 
and computing power other than what was required to interface to the 
mainframe and to present data received from the mainframe computer to the 
user. In this scenario, each user was given time shared access to the 
computing cycles of the mainframe as well as to the programs and data stored 
centrally on the mainframe. 

With the development and proliferation of the personal computer in 
the 1980's another computing paradigm took hold. In this paradigm, a user 
worked on a dedicated "personal" computer and accessed a private set of 
application programs and data stored on the personal computer. Further, 
with this paradigm, no time sharing of processing cycles was necessary 
because the personal computer served the single user only. 

Another change in the computing paradigm was caused by the 
development of computer networking technology. Computer networking 
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technology links multiple computers to enable the transfer of data. The 
development of computer networking technology was particularly important 
in the corporate environment where sharing and exchanging information is 
of particular importance. One network architecture that has developed is the 
client-server architecture. In this architecture, one or more computers are 
configured as a "server." A server stores a set of shared resources such as data 
(generally organized by storage within the context of a database) and 
applications. Further in accordance with this architecture, one or more other 
computers are configured as clients to access the stored data and applications 
from one or more servers. 

Using this client-server architecture many companies have set up a 
system where various categories of corporate data are stored on various 
servers. In many cases, the client computers are based on different hardware 
platforms and run different operating systems. Further, in many cases, the 
server computers are just as varied in terms of hardware and operating 
system environments. For example, it is typical for a company to store 
human resources information in one type of database, inventory information 
in another, engineering documents and so on. Further, companies often 
need to access data stored in other types of data sources (storage vehicles) such 
as in an electronic mail system, or from a large mainframe data source. 

Accessing and/or updating data stored in these varied storage systems 
requires using a data management system tailored for accessing the particular 
type of stored data or directly invoking the application which stores the data 
(e.g. an email program, a word processor, the specific database and the like). 
Thus a user must learn separate interfaces for a variety of software 
applications in order to access, view and modify data from multiple sources. 
Additional system complexity is introduced when data access is desired from 
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a variety of computer platforms operating different operating system types. In 
these cases, conventional data access system and methods are ported for 
compatibility with more than one type of computer. 

Thus, there is a need for a system and method for accessing data that is 
stored in a variety of databases, in a variety of formats and on a variety of 
different types of computers. 

SUMMARY OF THE INVENTION 

In accordance with the present invention, a computer implemented 
system and method provides platform independent access to data stored in 
any one of a variety of data storage mediums such as SQL databases, 
mainframe databases, mass storage mediums, mediums accessible via a 
driver, electronic mail systems and the like. The invention includes a client 
module that provides a desktop operating environment having a desktop 
window operating "inside" a browser. The desktop window presents one or 
more books each representing data stored in a corresponding storage medium 
(e.g., on a particular server computer) and in one or more particular storage 
formats (e.g., in an SQL database format or in a particular electronic mail 
format). The books are represented by icons having a user-customized name. 
The invention also includes a server module in communication with 
multiple client modules. The server module includes a metadata for 
accessing data associated with each book. The server module further includes 
computer instructions that process data requests (access requests) received 
from the client module by (i) retrieving the metadata associated with the 
book, (ii) retrieving data corresponding to the metadata; and (iii) sending the 
retrieved data to the client module. 
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In accordance with the present invention, the client module is a 
browserware application. A browserware application is program code that is 
stored on a server and is accessed from and run within a browser running on 
a client computer. Advantageously, a browserware application (i) does not 
require user installation on the client side, (ii) is hardware and operating 
system independent on the client side and (iii) allocates a reduced amount of 
processing to the client computer thus reducing the use of memory and 
processing resources on the client computer. 

Further in accordance with the present invention, at a book provided 
by the client module is linked to (assocaited with) to data stored in a data 
source and to program code for viewing the stored data. Further, information 
stored in the server module's data object associates the name associated with 
the book with physical storage information (e.g., metadata) for retrieving the 
data. Data is then retrieved by processing the physical storage information to 
determine the location and format of the data being accessed. If the data 
resides in a database, then the location of the database is retrieved from the 
data object and an appropriate query is constructed then applied to the 
database. 

Still further in accordance with the present invention, the client 
module runs in a browser environment. The browser environment manages 
the interaction between the client module and the client computer operating 
system. The client module thus does not require installation on or 
configuration with the operating system of the client computer. Preferably 
the browser environment is a Java-compliant browser environment and the 
client module is a Java-applet. 

Yet further in accordance with the present invention, retrieved data is 
presented to a user in accordance with a viewing form and the system 
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additionally includes a scripting module for generating a customized viewing 
form. The scripting module includes a byte-code generator disposed to 
generate byte-code in accordance with user specified form layout. 
Advantageously, because the scripting module generates browser-compatible 
byte-code, the customized form displays data to the user from within the 
browser environment independent of the computer hardware platform or 
operating system on which the browser is running. 

Yet still further in accordance with the invention, the invention 
includes a user interface for configuring the server module for accessing data 
stored in any one of a plurality of storage mediums in any one of a plurality 
of storage formats. The user interface allows a user to specify physical storage 
information associated with data stored in one or more storage vehicles and 
stored in one or more data formats. The invention also includes a processing 
module in communication with the user interface. The processing module 
generates a data object using the information received from the user via the 
user interface. The data object associates the received physical storage 
information with a name (e.g. a data identifier). 

The features and advantages described in the specification are not all- 
inclusive, and particularly, many additional features and advantages will be 
apparent to one of ordinary skill in the art in view of the drawings, 
specification, and claims hereof. Moreover, it should be noted that the 
language used in the specification has been principally selected for readability 
and instructional purposes, and may not have been selected to delineate or 
circumscribe the inventive subject matter, resort to the claims being necessary 
to determine such inventive subject matter. 
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Brief Description of the drawings 

Figure 1 is a functional block diagram of a data access system in 
accordance with the present invention. 

Figure 2 is a diagram of the data organization structure of a book 
provided by the data access system shown in Figure 1. 

Figure 3 is a flow diagram of object to relational mapping to access data 
in accordance with the data access system shown in Figure 1. 

Figure 4 illustrates a desktop window of the desktop client module 
shown in Figure 1. 

Figure 5 illustrates a new manager dialog window provided by the data 
access system shown in Figure 1. 

Figures 6A-6C illustrate new book dialog windows provided by the data 
access system shown in Figure 1. 

Description of the preferred Embodiments 
The Figures depict a preferred embodiment of the present invention 
for purposes of illustration only. One skilled in the art will readily recognize 
from the following discussion that alternative embodiments of the structures 
and methods illustrated herein may be employed without departing from the 
principles of the invention described herein. 

Figure 1 is a functional block diagram of a data access system 100 in 
accordance with the present invention. System 100 includes a client 
computer 101, a server computer 102 and data sources 108 coupled via a 
computer network 103. Client computer 101 runs a desktop client 105 that 
provides access to one or more of the data sources included in data sources 
108. Access is provided by a data service application 106 running on a server 
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computer 102. Data service application 106 processes data access requests 
received from desktop client 105 and returns the requested data for 
presentation to a user from desktop client 105. Desktop client 105 
advantageously runs within a browser 104, eliminating the need for 
customization and configuration of desktop client 105 to a particular 
hardware configuration or to a particular operating system type. 

Client computer 101 is a personal computer, a computer workstation of 
other computer type suitable for running browser 104. Browser 104 is 
preferably a conventional Java-enabled (Java-compliant) web browser such as 
Netscape Navigator 3.0 or Microsoft Explorer 3.0. A Java-enabled browser is a 
browser adapted to run byte-code (written in the Java programming language) 
within the browser environment. The Java programming language is an 
object oriented programming language developed by Sun Microsystems and 
is defined in the Java Language Specification Version 1.0 by James Gosling, 
Bill Joy and Guy Steele (published by Addison-Wesley, August 1996) and in 
the Java Virtual Machine by Tim Lindholm and Frank Yellin (published by 
Addison-Wesley, September 1996), the contents of which are hereby 
incorporated by reference. In particular, browser 104 includes a Java Virtual 
Machine (JVM) that translates Java byte-code into object code for execution. It 
should be understood that although a preferred embodiment uses a Java- 
compliant browser, the principles of the present invention apply to uses of 
other browser types and uses with other types of byte-code virtual machines. 

Referring still to Figure 1, data access system 100 includes desktop client 
105 and an application programming interface (API) 123. Desktop client 105 is 
a "browserware application'' that provides a user with access to one or more 
of the data sources coupled to server computer 102. A browserware 
application is program code that is stored on a server and is accessed from and 
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run within a browser running on a client computer. Advantageously, a 
browserware application (i) does not require user installation on the client 
side, (ii) is hardware and operating system independent on the client side and 
(iii) allocates a reduced amount of processing to the client computer thus 
reducing the use of memory and processing resources on the client computer. 

In a preferred embodiment, desktop client 105 is a set of Java- 
compatible byte-code instructions forming a Java applet that runs within a 
Java-compliant browser. Desktop client 105 is identified by a tag. The tag in 
turn is embedded in a world wide web (Web) page written in hypertext 
markup language (HTML). Desktop client 105 is accessed (e.g., downloaded to 
the client computer and run within the browser) when the tag contained a 
Web page is used to activate a link from within browser 104. 

When desktop client 105 is running, browser 104 manages the 
interaction between desktop client 105 and client computer 101 (e.g., browser 
104 provides an interface between desktop client 105 and client computer 101 
and its operating system). Desktop client 105 therefore runs "within" browser 

104 rather than interfacing directly with the operating system associated with 
client computer 101. The compatibility of desktop client 105 is therefore 
advantageously determined by compatibility with browser 104 rather than 
with the type of hardware or operating system associated with client 
computer 101. Further, desktop client 105 need not be configured to the 
particular hardware associated with client computer 101. Thus, desktop client 

105 is platform independent and can run the same set of instructions on a 
variety of computer hardware and operating systems, provided each is 
running a browser that includes a virtual machine that can execute the client 
desktop 105 byte-code. This platform and hardware independence eliminates 
the need for porting code to achieve multiplatform compatibility. Instead, a 
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single version of desktop client 105 will execute on any platform having a 
Java virtual machine. 

Server computer 102 is a computer configured to serve multiple client 
computers 101. For purposes of simplifying Figure 1, the detail of only a 
single client computer 101 is shown. Client computer 101 is coupled to server 
computer 102 using network 103. Network 103 is preferablv an internal 
TCP/IP intranet although other networks uses such as the Internet or an 
extranet are used in accordance with the invention. 

Server computer 102 rims (executes) a data service application 106. 
Data service application 106 provides users at various client computers 101 
with access to one or more data sources included in data source set 108 Data 
service application 106 includes server side API 124, API proxy 125, forms 
module 126, view module 127, script module 128, replication module 129, 
security module 130, script compiler 131, data access module 132 
administration ("admin") tool 133, data source interface (DSI) 107 and JDBC 
110. 

Administration tool 133 is a program module that provides for system 
configuration and for the selection of data sources within data source set 108. 
Further, administration tool 133 allows a user such as a system administrator) 
to construct, for each selected data source, an access control list (ACL) 
specifying which users or user groups, are offered access to the particular data 
source. 

Server side API 124 is an application programming interface that 
processes information communicated to and from various desktop clients 
105. API 124 interfaces with API proxy 125. API proxy 125 is a program 
module that implements a remote method invocation (including object 
serialization) mechanism. The mechanism processes method calls received 
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from desktop client 105 for remote invocation. Remote invocation means 
that methods invoked at the client computer 101 side (e.g., by desktop client 
105) actually invoke methods on server computer 102 (e.g., on data service 
application 106). By remotely executing methods rather than downloading 
such methods to client computer 101 for execution on client computer 101, 
the use of client computer resources such as memory and processing power is 
conserved. API proxy 125 thus advantageously reduces use of resources of 
client computer 101. 

View module 127 is a program module that presents a user with a high 
level representation of data retrieved from a data source (e.g., a database 113). 
In one embodiment, data is presented in a row and column format where, in 
a design mode, the user selects which fields of a data source are displayed. 

Form module 126 is a program module that presents information 
associated with a selected row of data presented by view module 127. Selected 
information is shown in a customized form. Customized forms include 
widgets. Widgets are visual components such as buttons which, in 
conjunction with scripts cause the form to modify the presentation of data 
and perform presentation related processing. 

Script 128 is processing module that reads and executes or set of custom 
scripts (in byte-code) that are associated with the various widgets of a form or 
view. 

Script compiler 131 is a processing module that translates user- 
generated script text into byte-code. 

Replication module 129 is a processing module that provides 
functionality for mobile access of data. Replication module 129 copies 
information from a database, provides for its modification and copies it back 
into the database without performing an over-write. 
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Security module 130 is a processing module that manages security 
functions. Security module 130 encrypts data communicated between desktop 
client 105 and data service application 106. Security module 130 additionally 
manages user account and password information. 

Data access module 132 is a data access layer that manages information 
associated with views, forms, scripts, server names, user names, passwords 
and the like. Data access module 132 interfaces directly with data source 
interface (DSI) 132. Data access module 132 translates information between 
from the format used by API 124 and the format used by DSI 107. 

DSI 107 is a set of computer instructions that provide an interface 
between data service application 106 and data source set 108. 

Data source set 108 include structured query language (SQL) databases 
113, mail system 112, native database 121 and mass storage 134. Mail systems 
112 are conventional electronic mail systems including IMAP4 systems 115, 
POP3 systems 116, MAPI systems 117 and VIM systems 118. Native database 
121 is a database native to data access system 100. Native database 121 
provides an alternative data storage source and also stores administrative 
data used by data service application 106. Mass storage data source 134 is a 
storage device for information with large memory needs such as image and 
video data. SQL databases 113 are structured query language (SQL) databases, 
each accessed through a server computer 102. The various data sources 
included in data source set 108 can each reside on separate computers. It 
should be understood that the principles of the present invention apply with 
data sources residing on other computer configurations including where 
multiple data sources reside on a single computer. 

Data service application 106 additionally includes Java database 
connectivity module (JDBC) 110. JDBC 110 is a conventional application 
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programming interface for querying conventional SQL database available 
from Sun Microsystems. JDBC 110 provides capability to query databases 113 
to determine metadata including their connection status (e.g., whether a 
connection is established) and access, format and syntax information not 
specifically defined by the SQL. 

Figure 2 is a diagram of the data organization structure of a book 200 in 
accordance with the data access system 100. Book 200 is named personal 
contacts and provides access to information associated with personal contacts 
stored in a database. Book 200 includes a database identifier 201, a table 
identifier array 202, a join condition 203, and a plurality of views 204. 
Database identifier 201 stores information identifying a particular database on 
a particular server computer. Database identifier 201 is used to construct an 
address to communicate with the database corresponding to the database 
identifier. Table identifier 201 is an array of table identifiers that specifies one 
or more tables in the database. Join condition 203 specifies a particular join 
function to be used to combine the tables listed by table identifier 201. Views 
204 each specify a custom view of the joined data. View 204 includes a search 
condition 205, a selection (list) of attributes 206, and a plurality of forms 207. 
Search condition 205 is the equivalent of a where clause in an SQL statement. 
Selection of attributes is a list of attributes (fields) to be presented in the view. 
View 204 provides information that is used by service application 106 to 
construct a request for a database search result. Service application 106 
processes the request, queries the selected database and returns the result set 
in a dynamically created object. 

Figure 3 is a diagram of a dynamically created result set 300. Result set 
300 includes a set of result objects 301. Result objects 301 are each person 
objects including a set of attributes 302 (fields) associated with data 
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corresponding to the person. Attributes 302 includes, for example, start date, 
fax number, cell number, work number and home number. Each person 
object 301 is generated as a result of a database query constructed using a JDBC 
SQL call 303. The JDBC call 303 performs a table join of the person table 304 
and the phone number table 305 associated with the database identified bv 
book 300. The table join is perform using the person I.D. as the sole join 
column. Each returned person object is presented within a view as a row. 
Further customization and refinement of view data is performed using forms 
207. Forms 207 enable selective viewing of data within each view based on 
column characteristics. 

In operation, data access system 100 is preferably first configured bv a 
system administrator for access by multiple users. These multiple users are 
each preferably identified by user identifications (I.D.s) and by passwords. 
Users are preferably organized into "groups" based on characteristics tailored 
to a particular organization's need. For example, a company might arrange 
users into the following groups: engineers, sales staff, marketing, finance, test 
and production. The same company might additionally define a different set 
of user groups such as: part-time employees and full-time employees. 

During configuration, a system administrator selects data sources from 
data source set 108 and for each selected data source, generates an access 
control list (ACL) identifying which users or user group are given access to 
the particular data source. Administration tool 133 includes the program 
instructions that effect such system configuration. Further description of 
administrative configuration is described in the Admin and DataSource ACL 
Manager sections of the user's manual included in this specification. 

Once data access system 100 is configured as described above, then 
system 100 provides users with access to selected data sources from desktop 
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clients 105. On start up, a desktop client 105 is downloaded to a client 
computer 101 and service application 106 performs an initialization process in 
accordance with the system configuration. During the initialization process, 
service application 106 polls (using JDBC 110 for queuing database sources) 
each data source in system 100 to determine whether a current connection can 
be established. Provided that a current connection is established, service 
application 106 queries each connected data source to determine access syntax 
and format. Service application 106 thus generates and stores metadata for 
retrieving data stored in the connected data sources. 

After startup processing, desktop client 105 is copied from (downloaded 
from) server computer 102 to client computer 101 for execution. The copying 
and execution of desktop client 105 is initiated from within browser 104. 
Upon execution, desktop client 105 presents the user with a desktop window. 
Figure 4 illustrates a desktop window 400 in accordance with the present 
invention. The desktop window 400 presents a user with the option to select 
a set of books 402 that are available to the user. A book is representative of an 
information link to one of the data sources in data source set 108 and the 
applications used to process such data. Because desktop window 400 is 
provided by desktop client 105 running within browser 104, the data source 
set 108 is advantageously accessed without dependence on the hardware 
platform and operating system included in client computer 101. 

Desktop window 400 provides access to the data associated with each 
book 402 (e.g., enables the viewing of data associated with the book). Access is 
controlled by disabling selected items in a dropdown menu 404 that appears 
when a user selects a book 402. Selecting the open command from dropdown 
menu 404 causes a view manager dialog window 500 as shown in Figure 5 to 
be presented. View manager dialog window 500 is a dialog box that displays a 



- 14- 



WO 99/01802 



PCT/US98/13794 



list of available views 501 for a corresponding book 402. Selecting a particular 
view 501 causes data associated with the corresponding book 402 to be 
displayed in accordance with the format associated with the selected view 501. 
Desktop window 400 also includes a status bar that presents operational and 
status messages along the bottom of desktop window 400. 

Books are added and deleted by user or system administrators using 
interfaces presented from desktop client 105. To add (create) a new book, a 
"user selects a "New" command under "Books". This selection causes a new 
book properties window, 600 as shown in Figure 6A to appear. The new book 
properties window 600 includes a services box 601 that enables a user to select 
the service (e.g., the server) that contains the data source that the user wants 
to associate with the book. After a service is selected, the desktop client 105 
next presents an updated new properties window 602 as shown in Figure 6B. 
The updated new properties window 602 replaces services box 601 with a 
datasource box 603. Data source box 603 includes the name of dates sources 
(e.g., JDBC, MAPI, POP3, Native etc.) that are available from the selected 
service. 

After selecting one of the presented data sources, desktop client 105 
presents a set of dialog boxes that enable a user to further specify information 
for accessing the corresponding data source. For example, if a JDBC data 
source is selected, the user is presented with a dialog box such as the further 
updated new book properties window 605 shown in Figure 6C. Further 
updated window 605 includes a new box 606 titled "driver". The further 
updated window 605 provides a list of JDBC drives corresponding to 
configured JDBC drivers for selection. After selecting a driver, desktop client 
105 presents either dialog boxes enabling a uses to select a database by name 
and a table within the selected database. 
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If a user selects an electronic mail data source rather than a JDBC source 
from updated new properties window 602, desktop client 105 presents a user 
with a sequence of dialog boxes allowing the user to select the desired mail 
profile and its location. 

Alternatively, books are added to a desktop window 200 bv importing 
them from a server 102. To import a book, a users uses a set of dialog boxes to 
select a server computer 102 and to the select a book on that server. 

The following user's manual is illustrative of and further describes 
system and method of the present invention: 
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Sanga Pages: Version 1.0 




Pages Desktop Client - As an implementation of browser/server computing, 
the Pages Desktop client is an applet that gives Java-enabled browsers a window 
into Sanga Pages applications. 

Pages Desktop Server - The core of Sanga Pages, it allows clients to access 
"books of information* which represent links to data sources and the applications 
required to leverage that data. 

• Access controlled by user ID/password 

• "Book" metaphor for retrieving, storing and viewing Sanga Forms and Views 

• Network tools for remote access to personal customized Desktop Client 
through Internet and access to databases on other servers 

• Administrative tools for adding users and groups, broadcasting messages, 
and more 

Pages Form Design - Gives developers a set of GUI design components to 
create sophisticated front-ends for custom applications or templates for data 
viewing. Standard GUI controls include static text boxes, buttons, text fields, 
scrolling text, check boxes, radial buttons, pull down lists, and regular lists. All 
controls have selectable color, fonts and scripts. Also includes variable granularity 
grids for alignment, group alignment, ana resizing. Includes standard reusable 
scripts. 

Pages Script - This robust, BASIC-like compiled programming language enables 
developers to add functionality to forms and create more detailed custom 
applications. Together with Pages View Design and Pages Form Design this 
completes the package of plattornvindependent Java application development 
tools. Scripting options include declaring variables of different types, executing 
common looping and conditional expressions, creating extensions into the Sanga 



7 
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// Sanga Pages: Version 1.C 



Pages API Ubcarv displaying message boxes, pertorming field access ana votoo- 

^ ir ^!? 9 'K UP ?^ aete,tng ^ <*rtabase rwvigatton [next. last, previous 
etc.) syntax checking and error reporting. ^ 

Pages Security - Administrators can create access control lists and use DES 
encryption of sessions. Developers can also use wrappers that support Northern 

^n^^r^T^ ^gaPagesSe^ca^Sypt 
all data transmrtted to ana from Sanga Pages clients and SQL databases prcvkJe 
useHevel security, field level security and support digital signatureT^' 

SK!?? " H?l S !ff 0rtS and intearates « major protocols (including POP3/ 
SMTP. MAPI and IMAP4) with attachment support. y 

Pages Replication - Sanga Pages allows users to copy databases across 
Ptattorms tor efficient aMtoured^atabase applications and to update different 
copes or the same database. 

Pages View Design - Sanga provides a flexible auery tool that enables users to 
create custom ad hoc views of data. Thbtooi Is perfect for managing large 
amounts of data dnd letting end-users fitter and present infan^oiSf^S 
aatatoses nghtfrom wtthin their browser. Operands supported include <.> <> = 
and . or. tike. Users can specify which database fields to view and adjust the 
order, name, and column width of those fields. 
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Introduction 




This manual introduces you to Sanga Poges Version 1 .0. It contains all me informa- 
ton and instructions you need to use Poges Desktop Client. Poges Server. Pages 
View Design, Pages Form Desiga Pages Script and Pages Security. 

This manual assumes you are familiar with either Netscape Navigator 2.0 (or 
better). Microsoft Internet Explorer 3.0 (or better), or other equivalent web browsers 
capable of running Java applets. 



Chapter Descriptions 



The following list outlines the chapters in this manual and their contents: 

Introduction", which you are currently reading, introduces the manual and the 
features of Sanga Rages. 

•Starring Pages Desktop Client" describes how to start and exit Pages Desktop, and 
reviews the components of the Poges Desktop window. 

"Quick Starr provides instructions on rx>w to accompli 
Desktop. 

Toges Desktop Commands" describes in detafl the commands available in Pages 
Desk to p. 

•POges View Design" describes in detai howtoaeatearxaedtta viewof aPoges 
Book. 



T 
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2 /production 

"Pages Form Design* describes m aetail how to create ana eait a form usea to 
examine me fields of a Pages Boole 

"Pages Script" describes in detail the syntax of the Rages Script language. 

"Pages Security* explains the security features available in Sanga Pages. 

"Pages Server* describes in detail the features and tools available to an aammistra- 
tor of Sanga Pages. 

Manual Conventions 

This manual uses certain conventions, including the typographical conventions in 
the manual itself, keyboard conventions for using Sanga Pages and the terminol- 
ogy describing mouse techniques. 

Common Actions 

This manual uses the following terms to mean specific actions: 
Select 

Select means you indicate an item by clicking once on the item to move the 
highlight to the item. For example: 

• you select one option button from a group of option buttons: 

• you setect an item in a drop-down box; 

• you select a file name in a dialog box or 

• you select a check box. 
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Choose 

Choose means you carry out an action. This means double-clicking on an item, 
or pressing ENTER once the Item is selected. Choosing an item causes something 
to happen immediately. For example: 

♦ you choose a command from a menu; 

♦ you choose a command button in a dialog box 

• you choose OK in a dialog box to activate any changes you have maae; or 

• you choose CANCEL to close a dialog box without making any changes. 



Typographical Conventions 

This manual uses various typefaces, including; 
SMALL CAPS 

Entries in small caps represent specific keys on the keyboard that you press. 
Graphk:symbots or abbreviate 

Monospaced 

Monospaced type indicates a command that you type. 

Italic 

rratic type means you replace the text in Italics with your own text, 
(square brockets] 

Items in square brackets are options in commands 
Bold 

Menu selections, commands, and controls in dialog boxes use bo*d type. 



Mouse Techniques 

A one or two word term Identifies commonly used actions. In this manual, these 
terms are used to avoid repeating detailed descriptions of the action. These 
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Terms are: 

• point means you move tne mouse pointer on the screen until It rests on 
the commana or item you want to select. 

• click refers to tne action of pressing ana releasing the mouse button auicWy. 
The instruction to click something means you use the left button on the 
mouse, while right-click means you must use the right button. 

• double-ciick means you press the left mouse button twice while on the 
indicated object 

• drag means you press end hold the mouse button while moving the 
mouse. 
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Starting Pages Desktop Client 



This chapter introduces you to Pages Desktop Client. It describes how to start ana 
exit the application, and reviews the components of the Pages Desktop window. 
For the purposes of this manual. Pages Desktop Client will be referred to as Pages 
Desktop. 

To start Pages Desktop, open your preferred Java-enabled web browser (i.e. 
Netscape Navigator, Microsoft Internet Explorer, et cetera) and call up the Pages 
Desktop site. The Rages logon window will appear asking you for your user id. 
password, and desktop service. Enter both you user Id and password and setect 
the desktop service you wish to use from the dropdown list |the default value is to 
use the local service). Select OK to continue. If you do not wish to log on at this 
time then either close your web browser or open a new location to end the Logon 




if you select OK and the user kJ and password are vattd, the Pages Desktop 
window wffl appear in the default setting developed tv your Sanga Pages admffiis- 
trator. 

■ jr 
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Pages Desktop Window 




Pages Desktop uses a tabular layout common to many Windows applications. 
This discussion assumes a standard installation with a default configuration. 

The mam portion of the Pages Desktop is the tabbed panel used to organize the 
books of a Pages user. Inrttarry there win be one tab without a title. 

The Button Bar appearing down the left side of the window shows the initial 
selections available. Under Tabs", New, Rename, and Delete appear; Under 
'Books', the buttons called New. Import and Arrange appear. Save and 
About are the last two buttons. 

The Status Bar, which gives you operational and status messages, appears along 
the bottom of the Pages Desktop window. 
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Quick Start 




This chapter gels you started using Pages Desktop for some basic tasks, including 
viewing data in forms and entering data into forms. These instructions proviae you 
with the ability to get up ana running with Pages DeskTop quickly. 

All of the instructions in Quick Start assume that your administrator has already set 
up your desktop, provided you with Pages Books you can import and you are able 
to Log onto to your Fdges Desktop, tf you are setting up your own desktop 
please refer to the chapter entitled "Pages Desktop Commands'. 



Importing a Pages Book 



This wiH show you how to quickly import a Pdges Book to get working right away 

1. On the main Pages Desktop select the Import button under the "Books- 
heading. This will bring up the import books dialog window. 




7 
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2. From the aropdown list of servers (Pages Servers) cnoose me same one 
you logged onto (unless your aammistrator has placed the oefautt boots 
in another location). A list of the Pages Books available for import appears 
in the selection list. 




3 . Select a book you wish to import from the list and click on the OK button. 
The dialog window should disappear and the selected tab in the Pages 
Desktop should now contain the Pages Book you just imported. 

View the data in the Pages Book 

With the Pages Book you just Imported, you should be able to use the Views and 
Forms to inspect the data. To view the data in a Pages View: 

1. Click on the Pages Book to bring up its dropdown menu. 
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2. Select me Open... item. This wiii bnng up the View Manager ataiog winaow 
which win display a list of avertable Pages Views. 




Select the View you wish to use from the list and click the Open button. This 
will bring up a View window containing data from the Pages Book. 




To view the data in a Pages Form : 

1. Click on the Pages Book to bring up its dropdown menu. 

2. Select the New... item This will bring up the Form Manager dialog window 
which will display a list of available Pages Forms. 
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3. Select the Form you wish to use from the list ana click me Open button. This 
will bring ud a Form window containing data from an entry in me Rages 
Book. 




Field Help 



When you place your cursor on a button in Rages Desktop, me help field unaer 
the workspace area will indicate me function of the button. For example; if you 
place your cursor on me New button undemeam •Tabs*, you wfll see the message 
"Create new workspace* beneath the current workspace. 



Creating a New Tab 



1. in the Pages Desktop window, click on me New button under "Tabs'. A new 
window will appear called "New Tab*. 




In the text box following Desktop Name, 
the tab. 



enter the name you want to can 
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3. Select the OK button to save me cnosen tab name or Cancel to return to 
the Pages Desktop window. 

4 . ft you select OK. a new tab will appear in the Pages Desktop winaow wrtn the 
name you have cnosen. 



Renaming a Tab 

1 . In the Pages Desktop window, select the tab you wish to rename bv clicking 
on the tab name. This action will move the tab to the front of the other tabs. 

2. Click on the Rename button under Tab. A new window will appear called 
•Rename Tab". 




3. In the text box following New Desktop Name, enter the new tab name. 

4. Select the OK button to save the new tab name or Cancel to return to the 
Pages Desktop window. 

5. If you select OK, the original tab will appear with the new name you hove 
chosen. 



Deleting a Tab 



1. tn the Pages Desktop window, select the tab you wtsn to detete by clicking on 
the tab name. This action wi move the tab to the front of the other tabs . 
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2. Click on me Delete button unoer Tabs. A new window will aDpear called 
•Delete Confirmation'. The message in the window is "Are you sure you want 
toaeletethistabr 




3. If you select the No button, the request for deletion will be canceled and you 
will return to the Pages Desktop window. 

4. If you select the Yes button, the tab selected will be deleted, including the 
books within the tab. 



Creating a New Book 



In the Pages Desktop window, select New under "Books*. 



2. A new window will appear entitled "New Book Properties'. In the "Services' 
box, select the service that contains the data source you want this tages 
Book to reference. Either double-click on the selected service nameorselect 
Open from the bottom of the window. 
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A new dox wilt replace the "Services* box coiled "Pages Data Source*, in tne 
box are all me names of the data sources (i.e.. JDBC. MAPI. POP3. Native) 
available to you from the service you just selected. Select the aara source 
you wish to use for your Boot Then select Open. 




Depending upon the type of data source you selected, the remaining dialogs 
wiH differ as follows: 



JDBC 



a) Another new box wiH replace "Pages Data Source' catted "Driver. 
Select the JDBC driver (these wilt correspond to the configured ODBC 
drivers) you wish to use for your Book and then select Open. 



tWIIIlk p.i- c 
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b) A new window appears called "Connect information', in tne rexr oox 
following User ID", enter your user id and then select OK. 




c) A new window appears reauesting your password. Enter your password 
in the text box and then select OK. 




d) The next message in the tsiew Book Properties* window is "Database 
Name." Select your chosen database and then click on Open. 




e) A new message appears in the New Book Properties* window asking 
for the Table Name*. Select the table name you wish this book to 
represent and then select Open. 
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MAPI 

a) Another new box will replace "Pages Data Source* called "Profile 
Name'. Select the mail profile you wish to use for your Boole ana tner 
select Open. 




POP3 

a) A new window appears called 'Connect Information- . in the text box 
following *MaO (POP3) Server, enter the address of the server and then 
select OK. 




b) A new window appears requesting the location of your SMTP Server. 
Enter this information in the text box and then select OK. 
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c) A new wtnaow aopears reauesting your user name, in me Text dox 
foUowtng User Name', enter your user id (or the mail server ana men 
select OK. 




d) A new window appears requesting your password. Enter your password 
in me text box and then select OK. 




Native 

a) Another new box win replace "Pages Data Source* called •DataBase". 
Select me native database you wish to use for your Bode and then 
select Open. 
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5. A new wmaow appears called "Boo* Name*. Enter a name for your dook. 
select an icon to represent the boo* ana then click OK. 



6. The new Pages Book icon labeled with the name you have chosen will appear 
in the current workspace in Rages Desktop. 



This feature allows you to import an existing Pages Book into your Desktop. The 
book you wish to import can exist either on your local service or any other avail- 
able service in the network. 

1. Select the Import button undef "Books. 

2. A new window appears called •Import Books'. Select a server (Pages Server} 
from the dropdown box fottawing the prompt.(insert importl .bmp) 




3. Alistofailtheft3c^BcK*savctob^ appear in the box 
underneath the Server prompt 

4. Select the book you wish to Import to yourdesktop. Click OK to import the 
book and return to your main desktop window. Tr^irTported book to 
appear in your current workspace. 





Importing a Book 
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Save 



About 



5. Select Cancel to return to the mam aesktop wtnaow wrtnout importing me 



If you select the Save button, you will save the format of your desktop as well as 
all the books and forms you have created. It Is suggested that you save your 
aesktop periodically during the time you use rt to prevent losing the forms ana 
views. 



If you select the About button information about product, including the version 
number will be displayed in a window. Click on the OK button to dismiss the 
window. 



To work with a Pages Book, click once on the book's icon. A drop-down menu will 
appear with the following choices: 



This option aBows you to open a previously created Pages View of the book. 
1 . Select Open... from the BooKs dropdown menu. 



book. 




Working With a Book 



Open 
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2. A new winaow appears catted View Manager This will present a list of 
available Pages Views for the boo*. 




3. To select a view either typo the name in the text box following the View 
Name' prompt ex select a view from the list. 

4. Click on the Open button to continue or Cancel to return to the main 
Pages Desktop window. 

5. If you selected Open a new window appears entitled View - VfevvName*. 
where ViewName matches the one selected in step 3. You cannot edit this 
view but you con use the Query tool on the data. The Query tool oBows you 
to filter the data of the view by applying a set of selection criteria. Wtththe 
tool you can filter on a single database field or a combination of up to four. 
There are three elements to each selection criteria: 

a) Database Column • this is a list of all cofumns in the database 

b) Comparison - the tools for comparison are equals (=). not equals (<>). 
less than (<), greater than (>) and like (LIKE). 

c) Value - this is the value to compare against. 

For example one selection criterion applied to an Employee database may 
be: YearsOf service > 5. This would return a view of all employee 
recocasintheadtabasewtrhavaluernth^ greater 
than five. 
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The selection cntena can be joinea wim erther AND or OR. if AND joins two 
selection cmeria then both must return true for the record to be displayed in me 
view. Using OR In the fitter fist means that a record which marches any of the 
selection criteria wfl be included m the view. 




6. Close the window to return to the main Boges Desktop window. 



New 



This option allows you to open a previously created Pages Form for viewing the 
entries in a Pages Boole 

1. Select New... from the Book's dropdown menu. 

2. A new window appears caDed 'Focm Manager*. This will present a list of 
available Pages Forms for the book. 




3. To select a form erttw type the rxrn^ 
Name' prompt or select a form from the tet. 

4. Click on the Open button to continue or Cancel to return to the main Pages 
Desktop window. 
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5. If you selected Open a new winaow appears enrmea "Pages Form - . You 
cannot edit the layout of this form Put a property createa form snouia anow 
you interaction with the acta. 




Design:Views... 

This option allows you to create, edit, and delete views of the Pages Book. 

1 . Select Design and then Views... from the dropdown menu. This will bring up 
the •view Manager* window used for working with Pages views. 

For further information on accessing the functionality of the " View Manager - 
window, please refer to the chapter entitled "Pages view Design*. 

Design:Forms... 

This option allows you to create, edit, and delete forms of the Pages Book ele- 
ments. 

1 . Select Design and then Forms... from the dropdown menu. This will bring 
up the Torm Manager* window used for working with ftiges Forms. 

For further information on accessing the functionality of the Pages Form Design, 
please see that chapter. 

Rename 

Thte optton allows you to rename the Book. 

1 . Select Rename from the drop-down menu. 
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2. A new winoow entfflea -Rename Book* appears. In the text box following me 
message New book name, type in the new name for me book. 




3 . If you are satisfied with your new name, click OK to return to the main menu. 
You will see that the new name of the book has replaced the old name unaer 
the icon. 

4. If you decide not to rename the book, click the Cancel button to return to 
the main drop-down menu. 



Copy 

This option is not part of Sanga Pages Version 1 .0 

Replicate 

This option is not part of Sanga Pages vfersion 1 .0 



Delete 

This option allows you to delete the selected Pages Book. 

1 . Select Delete from the dropdown menu. 

2. A confirmation screen will appear asking you "Are you sure you want to 
remove the selected bookT 

3. Select Yes to confirm the deletion and the Pages Book will be removed from 
the Desktop. 

4. Select No to cancel the deletion of the book. 



.44- 



WO 99/01802 



PCT/US98/13794 



lcon:Stick and lcon:UnStick 

These options allow you to snare and/or move Pages Books between me tods of 
me Desktop. 

1 . To share a Pages Book among the tabs of your Desktop, simply select Icon 
and then Stick from the book's aropaown menu. Now if you move among 
the various tabs of your Desktop you will see book is visible to ail of them. 

2 . If you want to move a Pages Book from one tab to another begin by 
following the same procedure in step 1 . Now move to me tab where you • 
wish to move me book to and select icon and men Unstick from me cook's 
dropaown menu. Now me book is onfy visible onmat tab. 



Properties:Show 

This option shows you all the Book's properties (i.e. data source, driver, user name, 
et cetera) 

1 . Select Properties and then Show from the book's dropdown menu. 

2. A new window appears called "Book Properties*. This window contains infor 
motion about the book you have opened including the name and the Pages 
Data Source. OttwWorrTxittondispkiyed depend on the type of Rages 
Dcrta Source the book is linked to. 




3. Select OK or Cancel to return to the main Rages Desktop window. 



Properties:ACLs... 

This option aHows you to create an Access Contra* list (ACL) for you Pages Book. 
Creating an ACL wll ensue that on ty authorized users can import you book. 
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1 . Select Properties ana then ACLs... from me book's aropaown menu. A 
new winaow appears called "Boo* ACL Properties*. 




2. The Name of the book is displayed at the top. This value cannot be changed 
as it must match the Pages Book name. 

3. Below this are two lists; a User List and a Group List. The User List contains all 
local users managed by this service. The Group List contains the defauft 
system wide groups as wefl as any local V defined groups. 

4. Next to these lists are the Pages Permissions which are made up of the 
following set (Control Read, Update. Execute. Test for Existence. Delete. 
Create). Whenever a user or group is selected these check boxes will reflect 
the permission set for that user/group. To add (box contains a ^) or remove 
(box is empty) a permission simply click on the appropriate field and the value 
wOl be toggled. 

5. Select OK or Cancel to close this window and return to the Pages Desktop 
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Creating a View 

1 . Select Design and then Views... from the Book's dropdown menu. 



2. A new window appears called "View Manager'. 

3. Enter the name of the view you wish to create in the text box following the 
prompt for View Name. 

4. Click on the Create button. Two new windows, similar to those shown beiow 
[viewdesignl .bmp and viewtoolsl .bmp], appear entitled "View Tools - and 
VewDesx^-wevvAtarr^ whe 

5. in the *View Tools' window, select a field that you want included in the view 
from the Column list 



6. The Name of the field will appear in the text box following label: in the 
Properties box. tou can change the label of the column in the view by 
deleting the default name for label and then entering one of your choice. 

7. To display the selected field in the v>ew you are creating, select the Display 
in view check box. You w« notice that there is a new column in the "View 
Design* window whose title matches the label of step 6. 

8. Continue to select fields for the view you are designing by folowing steps 5 to 7. 
Eoch field that is added when the Disptay in view check bax selected wi 
appear in the "View Design' window Once you have selected aH the fields 
needed for your view, you may now test the view design 

21 
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9. When aaaing beias to the view, the Mode menu on the View Design' 
winaow should have Layout selected. To test accessing and dtsotavtng 
information in your view, select the test option unaer the Mode menu on the 
"View Design' winaow. Testing the view will display the inf amotion of the 
columns you have selected from the book. 



1 0. To save the current view design at any time, select Save under the Rie 
menu to save the design under it's current name. Select Save As... under 
the File menu to bring up the "Save As...* dialog window which will allow you 
to save the aesgn with a different name or overwrite an existing view design. 

11. To exit the "View Design" window at any time, select Close Editing from the 
Rle menu on the View Design* window. 



1 . Select Design and then Views... from the Book's dropdown menu. 

2. A new window appears called "View Manager". 

3. Select the view that you wish to edit. The view name will appear in the text 
box foOowmg the view Name prompt. 

4. COck on the Edit button. Two new windows appear entitled "View Teds* and 
"View Design -wewtVame", where vrewfVame is the rKjrro 



5. In the "View Tools* window select tr^ field that you wish to edH In me v^ 
from the Column list. 




Editing a View 



step 3. 
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6. The name of the field will appear in the text box following Label in tne Prooer 
ties Pox You can edit the label of the column by deleting the current laoei 
name and then entering a new name for the column. 

7 . To change the field display of the view, select or de-select the Display in 
view check Pox, aepending on the selected field. You will notice the field 
and label changes happening concurrently in the View Design* window. 

8 . Continue to edit the view you are designing by following steps 5 to 7 . Once 
you have finished editing the columns in your view, return to the "View Design" 
winaow. 

9. When editing fields in the view, the Mode menu on the "view Design' window 
should have Layout selected. To test accessing and displaying information in 
your view, select the Test option under the Mode menu on the View Design' 
wndow. 

10. To save the current view design at any time, select Save under the File 
menu to save the design under it's current name. Select Save As... under 
the File menu to bring up the "Save As. .." dialog window which will allow you 
to save the design with a different name or overwrite an existing view design. 

11. To exit the View Design* window at any time, select Close Editing from the 
Rle menu on the 'View Design' window. 



Deleting a View 



1 . Select Design and then Views... from the Book's dropdown menu. 

2. A new window appears called View Manager'. 

3. Select the view that you wish to delete . The view name wiH appear in the text 
box following the View Name: prompt 

4. CBck on the Delete button. A new window wfll appear called "Delete Confir 
motion'. The message in the window is "Are you sure you want to delete the 
selected Item?" 

5. If you select either the No or Cancel button, the request for deletion will be 
canceled. 

6. If you select the Yes button, the selected view wtt be deleted . 
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7 . After confirming me deletion you will return to tne View Manager' winaow 
wnere you can select Cancel to close tne winaow. 
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Creating Forms 



1 . Select Design and then Forms... from the Book icon's dropdown menu. 

2. A new window appears called •Form Manager'. 

3. Enter the name of the form you wish to create in the text box following the 
prompt for Form Name. 

4. Click on the Create button. Two new windows, simitar to those shown below 
appear entitled ^Properties' and m Form Design'. 




"27 
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5. tn the "Form Design' winaow you can create several differem types of ODiects 
In your form: 



Creating a Text Label in Form Design 

1 . In the "Form Design" winaow. click on the Create text label button, or 
select Label from the tools menu. 

2. In the "Form Design* winaow again, click ana drag to create an aDoropriate- 
sized text. The text box can be resized at any time by selecting a resize tab on 
the text box and dragging it to me desired size. 

3. By default the word Text will appear in the label box you have created. 

4. Select the General tab of the "Properties' window. The default values of the 
text label will appear; the id for the text label will be 1abel#*. Label will 
contain the actual text for the label with the default of Text, and Reld will be 
"(none)". 

5. To change the Id of the text label srmpty enter a different ID instead of the 
default value following the "Font" label in the "Properties* window. 

6. To change the text inside the label, stmpry replace Text in the text box 
following the prompt for Label in the "Properties" window. 




r 



7. To adjust the font size and style of the text in the text label, cbck on the Font 
tab in the "Properties* window. 
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8. in me Font too, select your cnosen font from the aropaown wst following me 
Font: prompt 

9. Enter your selected font size rn the text box following Font Size. You atso 
have the option of making your font in the text label box bold ana/or italic 
by selecting the appropriate check boxes. 

1 0. To adjust the color of the text and the backgrouna of the text box select me 
Color tab in me "Properties* winaow. 

1 1 . To change the color of the text select me Foreground raato button. Then 
point and click your cursor on me selected color in the color dox. You will 
notice mat me text in me "Form Design" window's text label win change to me 
selected cola. 

1 2. To change the color of the background of the text label, select me Back 
ground radio button in the Cokx tab. Then point and click your cursor on 
your chosen cola in the color box You will notice mat the background of me 
text label in the •Form Design* window will change to the selected cola. 



Creating a Button 

1 . In the Form Design window, click on either the Create button tool button, or 
Button from me Toots dropdown menu. 

2. Oleic and drag to create an appropriate-sized button in the "Form Design" 
window. A three-dimensional button will appear with the default label of 
Button. 

3. In the "Properties* window, select the General tab. The default values of me 
button will appear; Id wfll be "button**. Label will be Button, and me Script 
button win reveal itself to be empty. 

4. To change the Id of the Button, simply enter in a different ID of the button 
rather than the default value. 

5. To change the label of the button from the default setting of Burton . simply 
enter the new button label In the text box following me prompt fa Label. 

6. To ox3d me script whtehwflen^ 

either select a database utility routine fromtt^dropdo^listacltekonme 
Script button. 
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7 . A new winaow ODDears caned *Scnpt • null". Enter the script coae wntcn 
enables the button to perform its aesired action tn the form. RememDer to 
enter a carriage return after eacn line. Please refer to the chapter on Pages 
Script for aetails on programming in Script. 



8. mm 




9. To adjust the font type and style of the text in the Button, click on the Font 
tab in the •Properties" window. 

1 0. You can change the font of the button using the dropdown box to choose a 
font. 



11. The font size is automatically set when you create the button. You have the 
options of making the button label bold and/or italic by selecting the 
appropriate check box. 

Note: 

Unlike text boxes, you cannot change the cokx of the text of the button label or 
the button itself. 



Creating Single-Line Text 

1 . In the form Design" window, click on either the Create single-line text 
tool button or Text Field from the Tools dropdown menu. 

2 . In the "Form Design" window again, click and drag to create an appropriate- 
sized text box. 
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3 . Select the General tab of the •Properties' wmaow. The default values of tre 
text box will appear; to will be textf ieta#* ana Reld will be •(none)'. 

4 . To change the Id of the text box simply enter a different ID insteaa of the 
aefautt value. 

5. Select the field of the book to be displayed in the text box by cnoosing one 
from me Field aropaown list. 




7 To adjust the font size and style of the text in the text box. click on the Font 
tab in the -Properties' window. 

8. In the Font tab, select your chosen font from the dropdown list following the 
Font prompt 

9. Enter you selected font size in the text box following Font Size. You also 
have the options of making your font in the text box bold and/or italic by 
selecting the appropriate check boxes. 

1 0. To adjust the color of the text and the background of the text box select the 
Color tab in the "Properties" window. 

11. To change the color of the text select the Foreground radio button. Then 
point and click your cursor on the selected color in the color box 

12. To change the color of the background of the text label select the Back 
ground radio button in the Color tab. Then point and click you cursor on 
your chosen color in the color box You will notice that the background of the 
text box in the 'Form Design" window wiil change to the selected color. 
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Creating a Scrollable Text Area 

1 . in the *Form Design' window, click on either the Create scrollable text 
area tool button or Text Area from tne Tools aropaown menu. 

2. in the •Form Design" winaow again, click and arag to create an aDDroonate- 
sized scrollable text area, in general these areas will be taller then the smgie- 
line text areas so as to display several lines of text at once. 

3. Select the General tab of the "Properties' window. The aefaurt values of the 
text area will appear; Id will be *textAreo#* and Field will be "(none]'. 

4. To change the Id of the text area simply enter a different ID instead of the 
aefault value. 

5. To setect a field from the book for the text area, choose one from the 
dropdown list following Field. 



6. 




7 To adjust the font size and style of the text m the text box. click on the Font 
tab in the 'Properties" window. 

8. Select your chosen font from the dropdown list following the Font prompt. 

9. Enter your selected font size in the text box following Font Size. YouaJso 
have the option of making your font in the text box bold and/or italic by 
selecting the appropriate check boxes. 

10. Toaa^mecotorof thetextarKjthebackgrourxl of the text box select the 
Cotof tab in the -Properties - window. 
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11 . To change the color ot the text select the Foreground raaio button. Then 
point and click your cursor on the selected color in the color box. 

1 2. To change the color of the background of the scrollable text area select the 
Background radio button m the Color tab. Then point ana click your cursor 
on your chosen cola in the color box, Vbu will notice that the backgrouna of 
the scrollable text area in the •Form Design' winaow will change to the 
seiectea color. 



Creating a Checkbox 

1 . in the •Form Design* window, click on either the Create checkbox tool 
button or Checkbox from the Toots dropdown menu. 

2. In the 'Form Design* window again, click and drag to create an appropnate- 
sced checkbox. 

3. Select the General tab of the •Properties* window. The default values of the 
text box will appear; Id will be *checkBox#*, the Label will be Checkbox, 
and Script will be empty. 

4. To change the Id of the checkbox simply enter a different ID instead of the 
default vatue. 

5. To change the Label of the checkbox, replace the original Checkbox label 
and enter one of your choice. 

6. To add the script which will enable the checkbox to perform its desired action 
either select a database uttirty routine from the dropdown fct or click on the 
Script button. 

7. A new window appears called "Script - nuir. Enter the script code which 
enables the checkbox to perform its desired oction in the form . Rememt 
to enter a carnage return after each line. Please refer to the chapter on 
Pages Script for detate on programming in Script 

8. To adjust the font size and style of the label of the checkbox. cHck on the 
Foot tab in the •Properties* window. 

9. Select your chosen font from the dropdown Hst following the Font prompt. 
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1 0. Enter your selected font size in the text box following Font Size. You also 
have the options of making me font of the checkbox label bold ana/or 
italic by selecting the appropriate check boxes. 

11. You cannot adjust the color of the checkbox 



Creating a Radio Button 

1 . In the 'Form Design" window, click on either the Create radio button tool 
button or Radio Button from the Toots aropdown menu. 

2. In the "Form Design* window again, click and drag to create an appropriate- 
sized radio button including a text label. 

3. Select the General tab of the •Properties' window. The defaurt values of the 
radio button will appear; Id will be *radioButton#". the Label will be Radio 
Button, the Group will be empty, and Script wit! be empty. 

4. To change the Id of the radio button, simply enter a different ID instead of 
the defaurt value. 

5. To change the Label of the radio button, replace the original Radio Button 
label and enter one of you choice. 

6. For any buttons in the same group, at most one of the buttons will be active 
at one time, when a button is selected, the previousry selected button is de- 
selected. If it is required for several radio buttons to provide toggles where at 
most one of the buttons can be active at one time, radio buttons should be 
added to groups. In the Group section you must define the group this radio 
button belongs to. 

7. To add the script which will enable the radio button to perform tts desired 
action, erther select a database utility routine from the dropdown list or click 
on the Script button. 

8. A new window appears called "Script -nutr. Enter the script code which 
enables the radio button to perform te desired action in the form. Remember 
to enter a carnage return after each tine. Please refer to me chapter on 
Pages Script for details on programming In Script. 

9. To odiust the font size and style of the text in the label text box, cfick on the 
Font tab in the "Properties* window. 
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1 0. Select your cnosen font from me arooaown list following me Font oromot. 

1 1 . Enter your selected font size in the text box following Font Size. You aiso 
nave me options of making your font in me text dox bold ana/or italic by 
selecting me appropriate check boxes. 



Note: 

You cannot adjust the color of a radio button. 



Creating a Dropdown List 

1 in me 'Form Design' window, click on either the Create dropdown list tool 
button or Choice from the Toots aropaown menu. 

2. In me *Form Design" window again, click and drag to create an appropriate- 
sized box for a dropdown list. 

3. Select the General tab of the •Properties' window. The defoult values of me 
dropaown list will appear; Id will be *choice#' and the Script will be empty. 

4. To change the Id of the dropdown list, simply enter a different ID instead of 
the default value. 

5. To add me script which will enable me dropdown list to pertorm its desKed 
action, click on the Script button. 

6. A new window appears catted •Script - nuHV Enter the script code which 
enables the dropdown list to perform Its desfred action in the form. Remem 
ber to enter a carriage return after each tine. Please refer to the chapter on 
Pages Script tor details on programming in Script. 

7. To a djust the font size and styte of the text in the dropdown list, ciic k on the 
Font tab in the -Properties - window. 

8. Select your chosen font from the dropdown Hst following the Font prompt. 

9. Enter your selected font size in the text box foflowtng Font Size. You aiso 
have the options of making your font in the text box bold and/or italic by 
selecting the appropriate check boxes. 

10. Toaajustthecotofoftotextarxjtt^b^ 
Color tab in the •Properties' window. 
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1 1. To change me color of me text, select me Foreground raato button. Then 
point ana click you cursor on me selected color in the color oox. 

1 2. To change me color of me background of the text label, select me Back 
ground radio button in me Color tab. Then point and click your cursor on 
your chosen cole ~ me color box You will notice mat me background of me 
aropaown list in me 'Form Design' window will change to me seiectea color. 



Creating a Scrollable List 

1 . In me "Form Design' window, click on either the Create scrollable list tool 
button or List from me Tools dropdown menu. 

2. In me Form Design window again, click and drag to create an appropriate- 
sized scrollable list box. 

3. Select me General tab of me "Properties' window. The default values of me 
scrollable list will appear; Id will be *form#" and Script will be empty. 

4. To change the Id of the scrollable list, simply enter a different ID instead of 
me default value. 

5 . To add me script which will enable the scrollable list to perform its desired 
action, click on the Script button. 

6. A new window appears called "Script - nulT. Enter the script code which 
enables the list to perform its desired action in the form. Remember to enter 
a carriage return after each fine. Please refer to the chapter on Pages Scnpt 
for details on programming in Script. 

7 . To adjust the font size and style of the text displayed In the scrollable Hst box. 
click on the Font tab in the "Properties' window. 

8. Select your chosen font for the text In the scroflabie list from the dropdown list 
following the Font prompt. 

9. Enter your selected font size in the text box fottowing Font Size. You also 
have the options of making your font In the text box bold and/or Italic by 
selecting the appropriate checkboxes. 

10. To adjust the cokx of the text and the background of the scroflable fist box. 
select the Color tab in the "Properties' window. 
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11 . To change the color of the text setect the Foreground roaio button. Then 
pant ana click your cursor on the selected color m tne color box. 

1 2. To change the coior of the background of the scrollable list box select tne 
Background radio button in the Color tab. Then point ana click your cursor 
on your chosen color in the color box \bu will notice that the backgrouna of 
the scrollable list box in the "Form Design" winaow will change to the seiectea 
color. 



Editing Forms 

1 . Select Design and then Forms... from the Book icon's aropdown menu. 

2. A new window will appear called "Form Manager'. A list of possible Pages 
Forms to select from are in the list under the prompt for Form Name. 

3 . Click on the form you wish to edit. The name of the form you have cnosen 
will appear in the text box following Form Names. 

4. Select Edit if you wish to use Pages Form Design to edit your selected form. 

5. Two new windows wiO appear called Properties" and 'Form Design*. Edit the 
Form using the same directions as the section on •Creating a New Form*. 



Deleting a Form 

1 . Select Design and then Forms... from the Book's dropdown menu. 

2. A new window appears catted "Form Manager". 

3. Select the form that you wish to delete . The view name will appear in the text 
box following the Form Name prompt. 

4. OJck on the Delete button. A new window wiH appear caBed "Delete 
Confirmation". The message in the window Is "Are you sure you want to delete 
the selected rtemr 

5. If you select either the No or Cancel button, the request for deletion wW be 
canceled. 
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6. if you select me Yes button, tne selected form will be deleted. 

7 . After confirming the deletion you wiD return to the •Form Manager' winaow 
where you can select Cancel to close the window. 
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Pages Script 




As described previously, Rages Script is a Basic-like compiled programming 
language which enables developers to put intelligence behind the forms created 
in Sanga Pages. Not just for straight-forward data access, Pages Script can be 
used for form routing, data triggers, validation, process automation, and many 
other advanced programming applications. Pages Script will be familiar to 
developers who are experienced with general scripting languages. Furthermore, 
this chapter is designed for those readers who have some experience with writing 
shell scripts. 



Using Variables 



Variable - a variabte is a named storage location that holds data that changes; 
every variable can hold onty one kind of data. 

Before you can use a variable in Pages Script, you must request that the variable 
be created by declaring the variable first To declare a variable means to give 
the name and data type of the variable. Once you have dec tared a variable, it 
always retains its original data type. A Pages Script program has no limit on the 
number of variables it declares. 



Pages Script Data Types 

integer Numeric values wtth no decimal point or fraction. Integer values 

range from -32.768 to 32,767. 

— JT 
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smng Data tnat consists of 0 to 2E + 38 characters of alphanumeric 

aata. Alphanumeric means that the aara can be Doth aiDha 
betic ana numeric. String data values may also contains special 
characters such as ~%@. 

dim Statements - aefine variables, dim - short for 'dimension" - is a Pages Scnot 
statement that you write in an application's Script window. 

Using dim. you tell Pages Script; that you have a variable, what to name me 
variable ana what kind of variable you want Always use a dim statement to 
define variables before you use variables. 

Format of the dim Statement: dim VarName as Datatype 

VorName is a name that you supply. When Pages Script executes the dim 
statement at runtime it creates a variable in memory and assigns it the name 
you give in the VdrNome location of the statement. 

DataType is one of the two Pages Script data types defined in the above table. 

For example, the following statement defines a variable named "ProductTotar : 
dim ProOucfTotal as integer 

From the dim statement you know that the variable holds integer data and that 
its name is ProductTotaL 

All Rages Script commands and buift-in routines are case insensitive. Although you 
do not ha ve to name your variables wtth an initial capital letter, most tages Script 
programmers do for the sate of consistency. Additional caps help distinguish 
individual words inside a name (Remember that you cannot use spaces in the 
name of a variable). 

Note: Never define two variables with the samename. Rages Script won't know 
which one you are referring to when you try to use one of them. 

Shortcuti - When you need to define several variables: 

Instead of listing each variable definition on separate lines Hke this: 
dim A as integer 
dim C as integer 
dim 0 as string 
dim E as string 

>bu can combine variables of the same data type on one tine. For example: 
dim A C as integer 
dim O. E as string 
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Assigning Values to Variables 

null string - a zero-length empty string mat is often represented as * ". 



Defining Variables 

Pages Script initializes with zeroes in the numeric variables ana null strings m me 
string variables. Use me "assignment statement' when you want to put omer acta 
values into variables. 

Format of the assignment statement: VarName « Expression 

The VarName is a variable mat you have aefined using the dim statement. 
Express/on can be a constant another variable, or a mathematical expression 
Example: Suppose you need to store a minimum age value of) 8 in an integer 
variable named MinAge The following assignment statement does that- 
MinAge ■ 18 



Mathematical Expressions 

Operator - a word or symbol mat performs data manipulation and/or comparison. 

Math Operators 

Table of Primary Mam Operators 



Operator 


Example 


Description 


+ 


Net + Disc. 


Adds two values 




Price -4.00 


Subtracts one value 
from another 


* 


Total * Fact 


Multiplies two values 


/ 


Tax/Adjust 


Divides one value by 
another 



-65- 



WO 99/01802 



PCT/US98/13794 



„ges ScnpT 

How to Use Mathematical Operators 

Suppose that you wanted to store me difference between the annual sales 
(stored in a variable named AnnucrtSaies) and me cost of sales (storea in a vanaoie 
named CostOf Sales) in a variable named NetSales. Assuming mat all three 
variables have oeen aefinea ana initialized, the following assignment statement 
computes me correct value tor NetSales: 

NetSales = AnnualSales - CostOfSales 

This assignment tells Pages Script to compute me value of me expression and to 
store me result in me variable named NetSales. 

No matter how complex me expression is. Pages Script computes me entire result 
before it stores mat result in me variable at the left of me eauals sign, in me 
following assignment statement for example, is rather lengthy, but Pages Script 
computes me result and stores the value in a variable named Celsius: 

These two lines convert a temperature of 30° Fahrenheit to the correct tempera- 
ture in Celsius 

Fahrenheit = 30 

Celsius = (Fahrenheit-32) *9/5 

Combining expression often produces unintended resutts because Pages Script 
computes mathematical resutts in a predetermined order. Pages Script then 
computes aH multiplication and division (working from left to right - before any 
addition and subtraction). 

For example: 

Pages Script assigns 1 3 to Result In me following assignment: 
Resutt = 3 + 5*2 

tt is passtote to override the operator precedence by using parenthess. Pages 
Script always computes the values inside any pair of parentheses before anything 
else in the expression, even If It means ignoring operator precedence. 



Relational Operators 

RetarttonaJ Operators compare data values to one another. They test conditions 
that are either true or false. And mus they ony produce true and false answers. In 
other words, one data value is either more than another (a tm© resutt) or the dato 
value b not more than the other |a false resutt). 
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The Relational Operators 



Operator Usage Description 



> 


Sales > Goal 


The greater than operator. 
Returns true if the value on the 
left side of > is numerically or 
alphabetically greater than the 
value on the right. Otherwise, 
false. 


< 


Pay < 2000.00 


The less than operator. Returns 
true if the value on the left siae 
of < is numerically or alphabet* 
cally less than the right. Other 
wtSA fatso 


= 


Age = limit 


The equal to operator (some 
times called the equal operator) . 
Returns true if the values on Doth 
sides of = are equal to each 
other. Otherwise, false. 




FirstName > = •Mike' 


The greater than or equal to 
operator. Returns true if the 
value on the left side of >= is 
numerically or alphabetically 
greater than or equal to the 
value on the right. Otherwise, 
false. 


< = 


Num < = IWAmtCaption 


The less than or equal to opera 
tor. Returns true if the value on 
the left side of <= is numerically 
or dphabeficatty less than or 
equal to the value on the right 
Otherwise, false. 


<> 


txtAnsJext < > "Yes* 


The not equal to operator. 
Returns true If the value on the 
left side of < > is numericafty or 
alphabetical unequal to the 
value on the right. Otherwise, 
false. 
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To unaerstand now relational operators work, you must unaersrana now to use rnerr 
true or false results. The If statement introduced in the next section explains now 
you can use true and false results to make decisions in your program. 



Keep Each Side a Consistent Data Type 

The expressions on both sides of a relational operator must have the same aata 
type or at least compatible data types. In other woras. you cannot compare a 
string to a numeric data type, if you try, you will get a Type mismatch error 
because the data types don't match. 



Program Flow Statements 

Lite all other programming languages, Rages Script supports both conditional 
statements and loops to determine the program flow. Prior to discussing the flow 
control structures we should mention Blocks. Slocks consist of one or more Pages 
Script statements. The block of statements found in a control structure are 
bounded by the start of the structure and the 'ending* statement. For example, 
an if statement completes with an end if statement or a do while loop ends with 
a loop statement. The Pages Script language supports nesting of these program 
flow structures. 



Conditional Statements 

The If... then... else Statement 

The rf statement uses relational operators to test data values. It performs one of 
two possible code actions, depending on the result of the test. With if state- 
ments. Pages Script tests whether to execute bkxks of code. The If statement 
makes decisions. If a relational test is true, the body of the rf statement ex- 
ecutes. 

One format of If: 

if retohonaflest then 
Block 

end if 
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The end If statement informs Pages Script wnere me rooav of me if statemenT 
enas. For example; 

if State = *NewY0rtc' men 
TaxRate = .0775 

end if 

if state = "Massachusetts' then 
TaxRate = .06 

end if 

The body of the If executes onry rf me relational test is true. Otherwise, the rest of 
the program continues as usual. 

A Shortcut Form of if called the Single-Line Format : if reiationalTest then 
PSStatement. 

This format does not reauire an end It statement because the relational test and 
body of the if are all in one line. 



Handling False Conditions 

The else statement executes code based on the relational test's false condition. 
The else statement is part of an extended if statement that specifies the code 
that executes If the relational test is false. 

Format of If Statement with else: 

if relattonalTest then 
Block 

else 

Block 

end if 
For example: 

i f (BankBatonce < 0) then 

Messogefiox ["Overdrawn") 

else 

MessogeBax (In Credit*) 

end if 

If the condition (BankBalance < 0) is true, then Overdrawn is displayed; If it is not, 
then In Credit is displayed. 
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Loop Statements 

Loops are usea when the same set of steos have to be camea out many times. 



The do white... ioop 

The do while statement performs flow control based on a relational exnressions 
just as me if statement aoes. The relational egression controls the looomg 
statements rather than a single block of code. Many lines of your program will still 
execute seauentially, but a loop will cause blocks of coae to repeat zero, one or 
many times. 



Format of the do while... loop: 

Do while (relational text) 
Block 

Loop 

The block of coae continues looping as long as the relational test is true. You can 
put as many lines of code in the block as long as the block itseff somehow 
changes a variable used in the relational test. The block of code will keep repeat- 
ing as long as the do while loop's relational test continues to stay true. Eventually, 
the retaticrMd test must becorra^ infinite loop. 

An example of the use of the do while... loop: 

answer = M 

Do while answer <> *N* && answer <> y 
Answer = toUpper(lnputBoxJ m Do you want to delete this record?*)) 

loop 



The for... loop 

The for loop is sometimes called the "For-Next* loop. Unlike the do loops, the for 
loop repeats for a specified number of times. Afor loop always begins with the 
for Statement and ends with the next statement 

Format of the for... loop: 

for CounterVar » Storfvb/ to BrxMsl /step IncrementaNai] 

Block 
next Counfervtrf 
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The loop in me fottowtng example computes tne tora or trie numoefs from i to 1C. 
Sum = 0 

for Number = 1 to 10 

Sum = Sum + Number 
r.ex: Number 



The Exit For Statement 

Sometimes, you'll be processing user input or several data values using looping 
statements, ana an exception occurs in me aato mat requires and immediate 
termination of the loop. For example, you may be collecting sales values tor a 
company's 1 0 sales divisions inside a Fa loop mat iterates ten times However, 
the user can enter zero for a division's sales value, indicating mat mere is no sales 
data for that division. Rather than complete the loop, your program might need 
to quit the loop at mat point because the full divisional report information can't be 
gathered at the time. 

The exit tor statement automatically terminates me loop. No matter how many 
iterations are left in me for loop, wnen Pages Script encounters an exit for state- 
ment. Pages Script immediately quits the loop and sends execution down to me 
statement following the loop. 

Typically an If statement triggers one of me exit statements like mis: 

for Divisions - 1 to 10 

Block //Code to get a sales value 

if (sales = 0) then 

exit for // Quit the loop early 

end if 

Block 
next Divisions 

The if ensures that the exit for executes only under one specific condition (a 
missing sales value). Wrrhoutthat specific corK3rftontriga^rmgtt^exttfor.meloop 
cycles normairy The exit for construct can only be used from within a for loop and 
is a way of leaving the loop irnmediatery. 
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Utility Functions 

There are about 70 utility functions mat are buirt into Sanga Script. These proviae 
useful shortcuts ana functionality to the Script user. 

To use these functions you must type the name in exactty as shown beiow al- 
though the functions are case insensitive. These functions can be broken up into . 
about 5 different groups Database, Screen, Math. String, Other. 



Screen Functions 

The Screen functions manipulate the different things you see on the 
screen. 



MessageBoxtmsg) returns void. 

where msg is the message you wish to display. 

This function puts a box up on the screen with the contents of msg inside. The 
script will then WAIT FOR A MOUSE CLICK before proceeding. The argument msg 
may be a string or a number. 



ConfirmMessageBox(msg) returns an integer, 

where msg is the message you wish to display. 

This function puts a box up on the screen with the contents of msg inside. Addi- 
tionally, there will be two buttons with YES and NO inside the box The user must 
click on one for the script to proceed. The function will return a 1 if the user clicks 
on YES and 0 it the user clicked on NO 



ScreenFieW(ftd) returns String 

where fid is the legitimate ID of an object on the screen. 

This function returns the contents of the rid object If the fld object is a list or a 
choice, rt will return the chosen element If there is no answer, the function will 
return an empty string. 
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setScreenFie»d{fia newVatue) returns void 

wnere rid is the legitimate ID of on object on the screen, 
where newvalue is what value you wish fld to take on. 

This function sets the contents of the fid object to the contents of the newvaiue 
variable. To set the list or choice oojects. you must use settistElement 



hideFieW(fld). showfield(fld) both return void 

where ftd is the legitimate ID of an object on the screen. 

These affect the reauested object on the screen. The hideFieid function makes 
the requested object invisible ana disabled. The user cannot see nor act on the 
screen object The showField function makes the object visible ana enabled. 



disabteFie*d(fld). enablef ieteJ(fid) both return void 

where fid is the legitimate ID of an object on the screen. 

These affect the requested object on the screen. The disablef ield function 
makes the reauested object gray and dead. The user cannot act upon the 
screen object. The erableField function redraws the object arxl makes » 



feWlsSetffld). fie*dlsResetffld) both return int 

where fld is the legitimate ID of an object on the screen. 

These are only to be used on checkboxes and radio buttons. These two screen 
element types can be in 1 of 2 states. Either they are ON or OFF. If there- 
quested screen object is ON, then the function returns 1 . if the requested screen 
object is OFF. then the function returns 0. 



setFieid(fld), resetFiekJ(fld), toggleFieWffid) all return void 

where ftd is the legitimate ID of an object on the screen. 

These osb onry to be used on checkboxes and radio buttons. These two screen 
element types can be in 1 of 2 states. Either they are on or off. The setField turns 
the requested object ON. The resetField rums the requested object OFF. The 
toggJeFteld object changes the state from ON to OFF or OFF to ON as the case 
requires. An object that is part of a group may not be turned off. You must turn 
ON a cflfferent object in that group. 
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ciearUst(fld) returns void 

wnere fid is me legrtimate ID of an object on the screen. 

This function is only to be used on a choice or list screen object. This function 
takes all the elements or selections off of the aesirea object. 



addlistEntryffld. entry). removeUstEntryfflcl entry) returns void 

where fid is the legitimate ID of an object on the screen. 

where entry is the String representation of the element to be affected 

These functions are only to be used on a choice or list screen object. The 
addListEntry function outs the String variable entry onto the ena of the choice or 
list object. This new entry may now be chosen by the user. The removeUstEntry 
takes the specified entry off the list. 



setMuttiple$etectionsffld)jeseM return void 

where tid is the legitimate ID of an object on the screen. 

These functions should onry be used on a list screen object. A list screen object 
may be used to make multiple selections off the list. You must first tell the list 
object to work in this manner. A list screen object wiH only allow one selection by 
default. Calling the setMuttipleSetection function with the fid argument as the 
screen ID will make the list screen object allow multiple selections. Calling the 
resetMurtipleSetection function with the fld argument as the screen ID will make 
the list screen object not allow multiple selections. 



getNumberSe*ected(fid) returns rnt 

where fid is the legrtimate ID of on object on the screen. 

This function should only be used on a list screen object. This function will return 
the number of entries the user has selected. This number may be anywhere from 
0 to the total number of entries on the list 



get$etection(ftd, setectionNumber) returns int 

where rid is the legitimate ID of an object on the screen, 
where setectionNumber tefls which select you wish returned 

This function should onfy be used on a fist screen object. Once you know the 
number of selections the user has chosen via the getNumberSetected call, this 
function can be used to get each individual selection. If there are more than 
one entries selected, then you must make multiple calls to this function. 
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Database functions 

DataBaseftefcl(fld) returns String 

where fid is trie legitimate ID of a field in the database. 

This function returns the contents of the field in the current record of the aatODase. 
if thefe is ax^ field, a ro cunenr record 



setDataBaseFieJd(fld, newValue) returns void 

where fid is the legitimate ID of an object on the screen, 
where newvdlue is what value you wish fid to take on. 

This function sets the contents of the field in the current record of the database to 
the contents of the newNfalue variable. If there is no such field, then the function 
will do nothing. 



updated returns void 

This function copies the contents of the screen to the database to be saved. 



deiete() returns void 

This function wifl remove the current record from the database. 



addnewf) returns void 

This function will get a blank record ready to be added to the database. You 
must follow this call with a can to update It you wish to permanentty add this 
function to the database. 



rncuenextO returns void 

This function changes the current record of the database by moving me record 
after the current record. All screen fields wifl automatically be changed to reflect 
this. 



-75- 



WO 99/01802 



PCT/US98/13794 



>rf PggesSc^ 

moveorev() returns void 

This function changes the current record of the database by moving me recora 
before the current record. All screen fields will automatically be cnangea to 
reflect this. 



moveflrstt) returns void 

This function changes the current record of the database by moving the record to 
the very first recora. All screen fields win automatically be changea to reflect this. 



movelast() returns void 

This function changes the current record of the database by moving the record to 
the very end record. All screen fields will automatically be changed to reflect this. 



movetoj recNumbef ) returns void 

where recNumber is the number of the new record you wish to 
goto 

This function changes the current record of the database by moving the record to 
the desired position in the database which is specified by the recNumber variable. 
All screen fields will automatically be changed to reflect this. 



getcurrecnum() returns int 

This function returns a number which represents your position in the database. This 
number will always be positive unless you are in the midst of adding a new record 
to the database. 



String Functions 



strten(str) returns int 

This function returns a count of the number of characters In the variable sir. 



-76- 



WO 99/01802 



PCT/US98/13794 



' gGg- . 55 

nght(srr. count) returns String 

This function returns a new string which is identical to the count rightmost charac- 
ters of the variable stt. 



leftfstr. count) returns String 

This function returns a new string which is identical to the count leftmost characters 
of the variable str. 



midstr(str, start count) returns String 

This function returns a new string which is identical to the count characters starting 
at the start character of the variable stt. 



concat(stt 1 , str2) returns String 

The function returns a new string which is identical to with str2 added on to the ena 
ofstrl. 



ntos(number) returns String 

This function returns a new string which Is the representation of number in string 
form. 



ston(str) returns Integer 

This function returns a number which is the equivalent of the string representation. 



sttcmplstrl , str2) returns Integer 

This function returns a number which is computed by comparing the string in stt 1 
with the string in str2. If sttl is the same as str2. the function returns a 0. If strl is 
alphabetically earlier than str2, then the function returns a - 1 . Otherwise, the 
function returns a 1. 
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smcmp(str. count) returns String 

This function is the same as strcmp above, with the exceotion that an uDDercase 
letter is considerea to De eaua) to the same towercase letter. 



rouppertstr), tolowertstr) return String 

This function returns a new string which is created by taking me argument and 
converting any lowercase characters to uppercase. Or uppercase to lower tor the 
toiower function. 



trim(str) returns String 

This function returns a new string which is created by taking the argument ana 
removing any leading or trailing spaces. 



charAtfstr, position) returns String 

This function returns an Integer representing the character at a specified position in 
the string. 

indexofchrtsft character) returns Integer 

This function computes and returns the position rn the string of the character 
argument tf the character is NOT in the string, then the function returns -1 . 



indexofstrtstrl , seorchString) returns Integer 

This function computes and returns the position in the string of the second string 
argument. If the search string is NOT in the string, then the function returns -1 . 



nexttndexofchftstr, character. startPosrrkxi) returns Integer 

This function is identical to the indexofchr function with the exception that the 
searching does not start with the first character but instead will start searching at o 
position in the third argument 
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nextinaexorstflstr. character) returns integer 

This function is identical to the inaexofstr function with the exception that the 
searcning does not start with the first character but insteaa will start searching at c 
position m the third argument 



Math Functions 

abs(number) returns Floating Point Number 

This function computes the absolute value of the argument. That is, it makes the 
number positive if it is not already so, and then returns it. 

cetl(number) returns Integer Number 

This function computes and returns the smallest whole number that is larger than 
the argument. 

floof|number) returns Integer 

This function computes and returns the largest whole number that is smaller than 
the argument. 

log(number) returns Floating Point Number 

This function computes and returns the natural log of the argument. 

sqrt(numDer) returns Floating Point Number 

This function computes and returns the square root of the argument 

powtnumbef. power) returns Floating totnt Number 

This function computes and returns the result of the first number raised to the 
power of the second number. 
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maxtnumoer I . numoer2) returns Floating Fbrnt Numoef 

This function computes ana returns the larger of the two arguments. 

min(number 1 . number2) returns Floating Point Number 

This function computes ana returns the smaller of the two arguments. 

Miscellaneous Functions 

copytosaeen(void) return void 

This function copies ail database fields into their corresponding fields on the 
screen. 

copvtobook(void) return void 

This function copies ail screen fields into their corresponding fields in the database, 
getdatefvoid) return String 

This function computes the current date and returns it as a string. The date is in 
MM/DD/YY format. 

gettime(void) return String 

This function computes the current local time and returns rt as a string. The time is 
in 24 hour HH:MM:SS format. 
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All Client and Service sessions are encrypted using DES (Data Encryption Stan- 
dard) encryption. The Pages Server administrator is also able to control which users 
and/or groups have access to the data sources and what kind of access the user/ 
group will have. For further information on administrating an ACL (Access Control 
List) of the data source, please refer to the chapter on Pages Server. 



37 
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To start the Pages Server: 

1 . Open System Command Shell (DOS shell in win95. c-shell in UNIX, et cetera) 

2. Change to the installation directory of Sanga Pages. 

3 . Invoke the "Start Server* shell script by entering the following: 

Start PagesServer 

4. A new window will appear caHed 'Pages Server hostname/IP address' This 
windows menu bar has three options; Action. Admin, and Options. The 
onlyother features of this window is a list where system messages generated 
andreceived by this service are displayed. Once you have started Pages 
Server, the message The Server is running... - should be highlighted to indi 
cate that it is the most recent system message. 
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Action 

Starting the Server 

1 . In me 'Pages Server" window, select Start from me Action aroDaown menu. 

2. A message will appear in me System Messages list: The Server is running. 

Stopping the Server 

1 . In me "Pages Server* window, select Stop from the Action dropdown menu. 

2. A message win appear in the System Messages list: "The Server is stopped*. 

Starting the Web Server 

1 . Select Start me Web Server from the Action dropdown menu. 

2. A message will appear in me System Messages list: The Web Server is running../ 

Stopping the Web Server 

1 . Select Stop the Web Server from the Action dropdown menu. 

2. A message will appear in me System Messages list: The Web Server is 
stopped.* 

Exiting Pages Server 

1 . Select Exit from the Action dropdown menu to shut down and exit from 
Poges Server. 

2. Close the Command Prompt window after Pages Server is stopped. 
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Login 

Login is the only option available in the Admin arooaown menu wnen you first 
start Rages Server. Once you have foggea in property, tne other .options wifi 
Pecome active. 

1) Select Login from the Admin aropaown menu. 

2) The "Pages Root Login" window appears on the screen. Enter tne Pages Root 
passwora at the text prompt. 




3) Once you have entered the password (It will appear in asterisk form), select 
OK to continue logging into the service or Cancel to return to the "Pages 
Server window without logging in. 

4) If you selected OK and the password was validated, you will return to the 
•Pages Service" window. Login should now have a checkmark in front of it to 
indicate that you have logged on successfully. The other options of the 
"Pages Server - menuPar will now be available. It there was a problem with 
the login (an invalid password perhaps), then an error message will be dis 
played in the System Messages list and you will be prompted to tTv again. 



User Manager 



User Manager acts as an administrative tool for managing users and groups on 
the service. 

1) Select User Manager from the Admin dropdown menu. 
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2) A new wtnaow aDDears called 'User Manager*. All the users on the service ere 
ilsrea by the Usemame. Full Name, ana the Login status. All me grouDs or. rre 
service are also listed. 







! " Har= = — ^ 










Mfl 



3) The User dropdown menu has five options: Add User..., Add Group.... 
Delete, Properties, and Exit. Instructions for using each of these options 
to follow. 

Adding q User 

1) Select Add User... from the User dropdown menu in the "User Manager* 
window. 

2) A new window appears called "Add User Dialog". 




3) To add another Rages user, enter the user name in the text box following the 
prompt for User Name, it must be at least three characters in length and 
should not contain any spaces. 
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4) Entef me real name of tne user in me text oox toilowing me promo: for Real 
Name. 

5) Enter me password tor me user in me text box following me oronrtDt for 
Password. 

6) Select which Groups you want this user to belong to. The-user must oeiong 
to at least one group. 

7) You can also set the aate when you want me oasswora to exoire by entering- 
in me number of days in me box proviaed. The numoer must oe between 0 
and 90. 

8) Select OK If you want to save me information you have entered about me 
user. You will return to me "User Manager" winaow where me new user snouia 
now appear in me User list 

9) Select Cancel to return to the "User Manager" window without saving me 
entered information. 



Adding a Group 

1) Select Add Group... from the User dropdown menu in the "User Manager" 
winaow. 

2) A new window appears called *dd Local Group". 




3) Enter the new group name in the text box fottowing the prompt tor Group 
Name. 
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4) Now you can aaa to or remove Local Users from me Group MemDers ust 

5) Select OK to save the information you have enferea apout me grouo. You will 
return to the "User Manager* winaow wnere the new group snouta now appear 
in the Group List. 

6) Select Cancel to return to the User Manager" wmaow wrtnout saving me 
enterea information. 

Deleting Users or Groups from Pages Server 

1 ) In me "User Manager* window, select the User or Group mat you want to 
aelete from me appropriate list. 

2) Select Delete from the User dropdown menu. 

3) A "Remove Alert! I* window appears to tell you mat your action will remove me 
selected User/Group. . 




4) Select OK to complete the deletion of the User or Group. You win return ne 
"User Manager" window and you should notice that me User/Group is no 
longer in me appropriate list 

5) Select Cancel to abort the removal of me User/Group from Ftiges Servers. 
You wrli return to the 'User Manager window. 



Administrating the Properties of Users 

1 ) Select me User you wish to work on from the Users list 

2) Select Properties from the User dropdown menu. 
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3) A new wmaow appears entmed User Propernes" as iiiusnaTea oeiow 




4) As you can see in the diagram. User Name cannot be changed. However, 
you can change the real name of the user by entering it in the text box 
following the prompt for Real Name. 

5) To change the password for the user, enter the new password in the text box 
following the Password prompt. The password will, of course, appear in 
asterisk form. 

6) To change the expiration date for the password, simply enter in the new date 
in the text boxes provided. The date must be between the current date and 
December31. 1999(99/12/31). 

7) To add or remove the user from User's Groups or System Groups, use the 
tools at the bottom of the window. Clicking on a group in the list of User's 
Groups and then selecting Remove-> will remove the selected group from 
that list and place It in the System Groups list. Clicking on a group in the list 
of System Groups and then selecting Add-> will remove the selected 
group from that list and place it in the User's Groups list Remember that a 
user must belong to at least one group so the User's Groups list cannot be 
empty. 

8) Select OK to save your changes. You wiD return to the "User Manager* 
window. 

9) Select Cancel to return to the User Manager* window without saving any 
changes. 
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Administrating the Properties of Groups 

1 ) In the "User Manager - winaow, select the Group whose Properties you wisn to 
view. . 

2) Select Properties from the User aroDaown menu. 

3) A new winaow appears entitled Tocal Group Properties' (as illustrated oeiow» 




4) As you can see In the diagram, this window allows you to add and remove 
Local Users to the Group where they become Group Members. COcking 
on a group in the list of Groups Members and then selecting Remove- > 
will remove the selected group from that list and place it in the Local Users 
list Clicking on a group in the list of Local Users and then selecting Add-> 
will remove the selected group from that list and place it in the Groups 
Members list. 

5) Select OK to save the changes that you have made and to return to the 
"User Manager' window. 

6) Select Cancel to return to the "User Manager window without saving any 
changes you have made. 



Exiting the "User Manager" window 

Select Exit from the User dropdown menu to close the "User Manager' window 
and return to the "Pages Service - window. 
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Data Source ACL Manager 

The Data Source ACL Manager provides a way to attach an Access Contra list 
(ACL) to the aata sources proviaea Dv the service. These lists are usea to ensure 
tne security of the aata sources ana to proviae access only to authonzea users. 
To use the Data Source ACL Manager, select Data Source ACL Manager trorr 
me Admin arooaown menu The "Data Source ACL Manager" wmaow aDDears. 
aispiaying a list of configured aata sources ana various actions that can oe 
Derformea (Add. Delete. Setup, and OK). 




Data Source List: This is a list of data sources tor which an ACL has previously 
been configured. Selecting an item in this list will allow you to either Delete or 
Setup the data source ACL Both of these options are aescribed below. 



Adding a Data Source ACL 

1 . Select the Add button in the "Data Source ACL Manager* window. 

2. A new window appears called 'Add Data Source ACL*. This window displays a 
list of afi the data sources provided by the service. 




3. Select the data source tor which you want to add an ACL and click OK. or 

4. Select Cancel to return to the "Data Source ACL Manager" window without 
creating a new ACL. 
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5. if vou selected OK in step 3. then me 'Data Source ACL SetuD* winaow will 
appear so vou can start configuring a new ACL for the aata source. Please 
refer to the section on Setting Up a Data Source ACL for information on mis 
winaow. 



Deleting Data Sources from the ACL 



. 1 . Select me aata source from me list displayed in me "Data Source ACL 
Manager" winaow. 

2. Click on me Delete button. 

3. A "Remove Alert!!* window will appear to warning you mat you are about to 
remove me aata source ACL 




4. Click OK to continue with me deletion and to return to me 'Data Source ACL 
Manager" window where you will notice the data source is no longer present 
in the list. 

5. Click Cancel to stop me deletion process. You will return to me "Data Source 
ACL Manager window. 



Setting Up a Data Source ACL 



The configuration of a data source ACL is managed by the "Data Source ACL 
Setup* window. This window can be entered by either: 

A] Adding a new data source and men setting the inffiat configuration (described 
in the previous section). In this case the blank ACL wtt be established with no 
permissions set. 
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B) Select a aata source from me list in tne 'Data Source ACL Manager - wincow 
ana clicking on the Setup outton. When entenng tnis way tne ACL's Drevious 
values will be loaaed. 




The above illustration displays the Data Source ACL Setup winaow which contains 
the following areas: 

1 . The Name of the Data Source is displayed at the top. This value cannot be 
changed as it must match the actual data source value. 

2. Below this are two lists, a Users list and a Groups list. The Users list contains 
all local users managed by this seivice. The Groups list contains the aefauit 
system wide groups as well as any locally defined groups. 

3. Next to these lists are the Pages Permissions which are made up of the 
following set: 

• Control • for the creator of the data source. 

• Read - allows readonly access to the data source. 

• Update - allows the user/group to update any changes made to the 
data source. 

• Execute - allow the user/group to execute a file outside of Sango Pages. 

• Test for Existence - determines whether or not the user has access to 
see data source. 

• Delete - allows the User/Group access to delete a data source, and 

• Create - allow the User/Group access to create a data source. 
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Whenever a user or grouD is selected mese cneck boxes will reflect me Dermis- 
sion set for mat user/group. To aaa (box contains o ✓) or remove (box is emoty) c 
permission simply click on me appropriate field ana me value will be toggiea 

4. Select OK to save me ACL ana return to me 'Data Source ACL Manager" 
winaow. if mis was a new aata source ACL being created men me aata 
source should now appear in me list of aata sources. 

5. Select Cancel to ignore all changes to the aata source ACL and return to 
me "Data Source ACL Manager* window, if mis was a previously existing aata 
source ACL men me original ACL will still be intact. If mis was a new ACL men 
all enterea data will be lost and no ACL will be created for me aata source. 



Exiting the "Data Source ACL Manager" window. 

Selecting me OK button will close the "Data Source ACL Manager* window and 
return you to me main "Pages Service' window. 



Options 



The third option available in me "tages Server* window is Options which has three 
additional tools for the Pages Server administrator. 



Show Services 

In me "Pages Server window, select Show Services from me Options dropdown 
menu. 

A new window appears called "Available Services*. A list of all me Pages Servers 
available on your intranet is displayed. 
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Click OK to return to me "Pages Server - winaow. 

Current Users 

1) In the "Pages Server winaow. select Current Users from the Options 
aropaown menu. 

2) A new window appears called "Current Users". A list of all the users currently 
loggea on the server are displayed. 



3) Click OK to return to the "Pages Server window. 



Broadcast Message 

The Broadcast Message tool is useful for Informing other users on the Server about 
any changes happening on the Service (i.e. "My server wiH be stopped in five 
minutes') or perhaps any social events happening in the company (i.e. "Big party 
at the FrreStation Friday night at 8 p.m. # ). 

1) In the Pages Server window select Broadcast Message from the Options 
dropdown menu. 

2) A new window appears caned •Broadcast Messoge'.finsert opttons3.bmp) 
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3) Enter the message you wish to send in the text box following the Message 
prompt. 

4) Click OK to send the message and to return to the Tages Services' winaow, or 

5) Click Cancel to exit the window without sending a message. You will return 
to the "Pages Services winaow". 
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The foregoing discussion discloses and describes merely exemplary 
methods and embodiments of the present invention. As will be understood 
by those familiar with the art, the invention may be embodied in other 
specific forms without departing from the spirit or essential characteristics 
thereof. Accordingly, the disclosure of the present invention is intended to be 
illustrative, but not limiting, of the scope of the invention, which is set forth 
in the following claims. 
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1. A system for accessing data stored in a plurality of storage mediums and in 
a plurality of storage formats, comprising: 

a client module having browserware application properties and 
providing a desktop having a plurality of books each associated with data 
stored in a storage medium; and 

a server module operatively coupled to the client module, the server 
module including computer instructions for performing the method 
comprising: 

storing information associating the book with metadata for 
retrieving the data associated with the book; 

receiving an access request identifying a data source from the 
client module; 

retrieving metadata corresponding to the data source; 
retrieving data corresponding to the metadata; and 
sending the retrieved data to the client module. 

2. The system of claim 1 wherein the client module runs in a browser 
environment. 

3. The system of claim 1 wherein the client module is a platform 
independent module. 

4. The system of claim 1 further comprising a scripting module having a byte- 
code generator disposed to generate byte-code from a form layout. 
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5. The system of claim 1 wherein the storage medium arranges data in a row 
and column format and wherein the book comprises: 

a data source identifier; 

a plurality of attributes each identifying a column; 
a join condition; and 
view information. 

6. The system of claim 5 further comprising a result object for returning the 
result of a data source query generated from the data source identifier, the 
plurality of table identifiers and the join condition. 

7. The system of claim 6 wherein the result object is presented in accordance 
with the view information. 

8. The system of claim 5 wherein the view information includes a selection 
of data attributes and a search condition. 

9. The system of claim 5 wherein the view information further includes a 
plurality of forms. 

10. A computer implemented method for accessing data stored in a plurality 
of storage mediums and in a plurality of storage formats, comprising: 

providing a client module having browserware application properties 
and having a desktop having a book identifying data stored in a storage 
medium; 
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providing a server module storing information associating the books 
with metadata for retrieving the data identified by the book; 

receiving at the server module a data access request from the client 
module; 

retrieving metadata responsive to the access request; and 
retrieving data stored in accordance with the metadata; 
sending the retrieved data from the server module to the client 
module. 

11. The method of claim 10 wherein the client module runs in a browser 
environment. 

12. The method of claim 10 wherein the client module is a platform 
independent module. 

13. The method of claim 10 further comprising:. 

providing a form layout interface having user customizable data 
display attributes; 

processing the customized form to generate byte-code disposed to 
display retrieved data in accordance with the customized form. 

14. The method of claim 10 further comprising: 

providing a user interface for identifying a data source; 

determining the physical storage information associated with the 
identified data source; 

generating metadata from the determined physical storage 
information; and 
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storing the metadata. 

15. The method of claim 14 wherein the identified data source identifies data 
stored in first and second tables in a database and includes a table join 
condition. 

16. The method of claim 14 wherein the identified data source is an electronic 
mail system. 
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